home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 49 / Amiga Format CD49 (2000-01-17)(Future Publishing)(GB)(Track 1 of 3)[!][issue 2000-02].iso / -in_the_mag- / banging_the_metal / clocks / resclock / setbattclock.doc < prev   
Text File  |  1999-11-30  |  2KB  |  38 lines
  1.  
  2. SetBattClock -- a KS1.2 compatible equivalent of OS2.0+ SetClock
  3.  
  4.    Starting with AmigaOS 2.0, the battery-backed clock is accessed through
  5. battclock.resource, instead of directly poking the hardware registers.
  6. Among other things, this allows programs like ResClock to take over
  7. battclock.resource, replacing it with their own software-based resetproof
  8. clock.
  9.  
  10.    ResClock should work quite well even under KickStart 1.2. However, the
  11. SetClock program provided on pre-2.0 Workbench disks uses its own method of
  12. accessing the battery-backed clock, entirely bypassing ResClock. To make
  13. ResClock useful even on these older Amigas, the support program SetBattClock
  14. is included.
  15.  
  16.    To use SetBattClock, place it somewhere along your path (such as in the
  17. C: directory) and replace all calls to SetClock in your S:Startup-Sequence
  18. with calls to SetBattClock. The arguments supported are:
  19.  
  20. SetBattClock load    ; loads time from battclock.resource to system clock
  21. SetBattClock save    ; saves time from system clock to battclock.resource
  22. SetBattClock reset   ; resets battclock.resource to 01-Jan-78, 00:00:00
  23.  
  24.    Note: SetBattClock's user interface can only be described as crude. It
  25. only looks at the first letter of its first argument. If none exists, or if
  26. it isn't 'S' or 'R', SetBattClock assumes it should load the time.
  27.  
  28.    Under KickStart 2.0 or later, SetBattClock should work exactly like the
  29. system SetClock command. Under earlier KickStarts it will fail silently
  30. with a return code of 20 unless ResClock is active.
  31.  
  32.    SetBattClock is part of the ResClock package, and is placed in the
  33. Public Domain. If you like ResClock / SetBattClock, or wish to report
  34. problems or suggest improvements, please send e-mail to Ilmari Karonen
  35. <iltzu@sci.fi>. The latest version of ResClock / SetBattClock should be
  36. available from Aminet or from my web pages at http://www.sci.fi/~iltzu/
  37.  
  38.